<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>Retrieve text document</title>

 </head>
 <body><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="function.hw-getsrcbydestobj.html">hw_GetSrcByDestObj</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="function.hw-getusername.html">hw_getusername</a></div>
 <div class="up"><a href="ref.hw.html">Hyperwave 函数</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.hw-gettext" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">hw_GetText</h1>
  <p class="verinfo">(PHP 4)</p><p class="refpurpose"><span class="refname">hw_GetText</span> &mdash; <span class="dc-title">Retrieve text document</span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.hw-gettext-description">
  <h3 class="title">说明</h3>
  <div class="methodsynopsis dc-description">
   <span class="type">int</span> <span class="methodname"><strong>hw_gettext</strong></span>
    ( <span class="methodparam"><span class="type">int</span> <code class="parameter">$connection</code></span>
   , <span class="methodparam"><span class="type">int</span> <code class="parameter">$objectID</code></span>
   [, <span class="methodparam"><span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span> <code class="parameter">$rootID/prefix</code></span>
  ] )</div>

  <p class="para rdfs-comment">
   Returns the document with object ID <em><code class="parameter">objectID</code></em>. If
   the document has anchors which can be inserted, they will be inserted
   already.
  </p>
  <p class="para">
   This function will only work for pure text documents. It will not open a
   special data connection and therefore blocks the control connection during
   the transfer.
  </p>
 </div>

 <div class="refsect1 parameters" id="refsect1-function.hw-gettext-parameters">
  <h3 class="title">参数</h3>
  <p class="para">
   <dl>

    
     <dt>
<em><code class="parameter">connection</code></em></dt>

     <dd>

      <p class="para">
       The connection identifier.
      </p>
     </dd>

    
    
     <dt>
<em><code class="parameter">objectID</code></em></dt>

     <dd>

      <p class="para">
       The object identifier.
      </p>
     </dd>

    
    
     <dt>
<em><code class="parameter">rootID/prefix</code></em></dt>

     <dd>

      <p class="para">
       The optional parameter <em><code class="parameter">rootID/prefix</code></em> can be a
       string or an integer. If it is an integer it determines how links are
       inserted into the document. The default is 0 and will result in links
       that are constructed from the name of the link&#039;s destination object.
       This is useful for web applications. If a link points to an object
       with name &#039;internet_movie&#039; the HTML link will be &lt;A
       href=&quot;/internet_movie&quot;&gt;. The actual location of the source and
       destination object in the document hierarchy is disregarded. You
       will have to set up your web browser, to rewrite that URL to for
       example &#039;/my_script.php/internet_movie&#039;. &#039;my_script.php&#039; will
       have to evaluate $PATH_INFO and retrieve the document.
       All links will have the prefix &#039;/my_script.php/&#039;. If you do not
       want this you can set the optional parameter
       <em><code class="parameter">rootID/prefix</code></em> to any prefix which
       is used instead. Is this case it has to be a string.
      </p>
      <p class="para">
       If <em><code class="parameter">rootID/prefix</code></em> is an integer and unequal to 0
       the link is constructed from all the names starting at the object with
       the id <em><code class="parameter">rootID/prefix</code></em> separated by a slash
       relative to the current object.
      </p>
      <p class="para">
       If for example the above document &#039;internet_movie&#039; is located
       at &#039;a-b-c-internet_movie&#039; with &#039;-&#039; being the separator between
       hierarchy levels on the Hyperwave server and the source document is
       located at &#039;a-b-d-source&#039; the resulting HTML link would be:
       &lt;A HREF=&quot;../c/internet_movie&quot;&gt;. This is useful if you want
       to download the whole server content onto disk and map
       the document hierarchy onto the file system.
      </p>
     </dd>

    
   </dl>

  </p>
 </div>

 <div class="refsect1 returnvalues" id="refsect1-function.hw-gettext-returnvalues">
  <h3 class="title">返回值</h3>
  <p class="para">
   Returns the text document.
  </p>
 </div>

 <div class="refsect1 seealso" id="refsect1-function.hw-gettext-seealso">
  <h3 class="title">参见</h3>
  <p class="para">
   <ul class="simplelist">
    <li class="member"><span class="function"><a href="function.hw-pipedocument.html" class="function" rel="rdfs-seeAlso">hw_pipedocument()</a> - Retrieve any document</span></li>
    <li class="member"><span class="function"><a href="function.hw-free-document.html" class="function" rel="rdfs-seeAlso">hw_free_document()</a> - Frees hw_document</span></li>
    <li class="member"><span class="function"><a href="function.hw-document-bodytag.html" class="function" rel="rdfs-seeAlso">hw_document_bodytag()</a> - Body tag of hw_document</span></li>
    <li class="member"><span class="function"><a href="function.hw-document-size.html" class="function" rel="rdfs-seeAlso">hw_document_size()</a> - Size of hw_document</span></li>
    <li class="member"><span class="function"><a href="function.hw-output-document.html" class="function" rel="rdfs-seeAlso">hw_output_document()</a> - Prints hw_document</span></li>
   </ul>
  </p>
 </div>

</div><hr /><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="function.hw-getsrcbydestobj.html">hw_GetSrcByDestObj</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="function.hw-getusername.html">hw_getusername</a></div>
 <div class="up"><a href="ref.hw.html">Hyperwave 函数</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
